home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglconvolutionparameterext.z / fglconvolutionparameterext
Text File  |  1998-10-20  |  14KB  |  205 lines
  1.  
  2.  
  3.  
  4. ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))                                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffEEEEXXXXTTTT,,,, ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiiEEEEXXXXTTTT,,,,
  10.      ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvvEEEEXXXXTTTT,,,, ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvvEEEEXXXXTTTT - set
  11.      convolution parameters
  12.  
  13.  
  14. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  15.      SUBROUTINE ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffEEEEXXXXTTTT( INTEGER*4 _t_a_r_g_e_t,
  16.                                              INTEGER*4 _p_n_a_m_e,
  17.                                              REAL*4 _p_a_r_a_m_s )
  18.      SUBROUTINE ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiiEEEEXXXXTTTT( INTEGER*4 _t_a_r_g_e_t,
  19.                                              INTEGER*4 _p_n_a_m_e,
  20.                                              INTEGER*4 _p_a_r_a_m_s )
  21.  
  22.  
  23.  
  24.  
  25. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  26.      _t_a_r_g_e_t  The target for the convolution parameter.  Must be one of
  27.              GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or
  28.              GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT.
  29.  
  30.      _p_n_a_m_e   The parameter to be set.  Must be GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT.
  31.  
  32.      _p_a_r_a_m_s  The parameter value.  Must be GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.
  33.  
  34.  
  35.  
  36. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  37.      SUBROUTINE ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvvEEEEXXXXTTTT( INTEGER*4 _t_a_r_g_e_t,
  38.                                               INTEGER*4 _p_n_a_m_e,
  39.                                               CHARACTER*8 _p_a_r_a_m_s )
  40.      SUBROUTINE ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvvEEEEXXXXTTTT( INTEGER*4 _t_a_r_g_e_t,
  41.                                               INTEGER*4 _p_n_a_m_e,
  42.                                               CHARACTER*8 _p_a_r_a_m_s )
  43.  
  44.  
  45.  
  46.  
  47. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  48.      _t_a_r_g_e_t
  49.           The target for the convolution parameter.  Must be one of
  50.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or
  51.           GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT.
  52.  
  53.      _p_n_a_m_e
  54.           The parameter to be set.  Must be one of
  55.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT, or
  56.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT.
  57.  
  58.      _p_a_r_a_m_s
  59.           The parameter value.  Must be GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT if _p_n_a_m_e is
  60.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT.  Otherwise, must be a vector of four
  61.           values (for red, green, blue, and alpha, respectively) to be used
  62.           for scaling (when _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT) or for
  63.           biasing (when _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT) a convolution
  64.           filter kernel.
  65.  
  66.  
  67.  
  68.  
  69.                                                                         PPPPaaaaggggeeee 1111
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76. ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))                                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee
  77.  
  78.  
  79.  
  80. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  81.      ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT sets the value of a convolution parameter.
  82.  
  83.      _t_a_r_g_e_t selects the convolution filter to be affected:
  84.      GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT for
  85.      the 1D, 2D, or separable 2D filter, respectively.
  86.  
  87.      _p_n_a_m_e selects the parameter to be changed.
  88.      GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT and GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT affect
  89.      the definition of the convolution filter kernel; see
  90.      ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDDEEEEXXXXTTTT, ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT, and
  91.      ffffggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT for details.  In these cases, _p_a_r_a_m_s is an array
  92.      of four values to be applied to red, green, blue, and alpha values
  93.      respectively.
  94.  
  95.      A _p_n_a_m_e value of GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT controls the convolution
  96.      border mode.  Currently the only acceptable parameter value is
  97.      GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.  When this mode is in effect, the image resulting from
  98.      convolution is smaller than the source image.  If the filter width is _W_f
  99.      and height is _H_f, and the source image width is _W_s and height is _H_s, then
  100.      the convolved image width will be _W_s-_W_f+1 and height will be _H_s-_H_f+1.
  101.      (If this reduction would generate an image with zero or negative width
  102.      and/or height, the output is simply null, with no error generated.)  The
  103.      coordinates of the image resulting from convolution are zero through _W_s-
  104.      _W_f in width and zero through _H_s-_H_f in height.
  105.  
  106. NNNNOOOOTTTTEEEESSSS
  107.      In cases where errors can result from the specification of invalid image
  108.      dimensions, it is the dimensions after convolution that are tested, not
  109.      the dimensions of the source image.  For example, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD requires
  110.      power-of-two image size.  When REDUCE_EXT border mode is in effect
  111.      (currently this is always true), the source image must be larger than the
  112.      final power-of-two size by one less than the size of the 1D filter
  113.      kernel.
  114.  
  115. EEEERRRRRRRROOOORRRRSSSS
  116.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not one of the allowable
  117.      values.
  118.  
  119.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _p_n_a_m_e is not one of the allowable values.
  120.  
  121.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT
  122.      and _p_a_r_a_m_s is not GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.
  123.  
  124.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT is
  125.      executed between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding
  126.      execution of ffffggggllllEEEEnnnndddd.
  127.  
  128. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  129.      ffffggggllllGGGGeeeettttCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                                                         PPPPaaaaggggeeee 2222
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142. ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))                                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee
  143.  
  144.  
  145.  
  146. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  147.      ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDDEEEEXXXXTTTT, ffffggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT,
  148.      ffffggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT, ffffggggllllGGGGeeeettttCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT.
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                                         PPPPaaaaggggeeee 3333
  202.  
  203.  
  204.  
  205.